stackLimit

Type

property

Summary

Allows a script to set (in bytes) the maximum size of the (runtime) stack the engineuses for recursive computation.

Syntax

set the stackLimit to <stackSizeInBytes>

get the [effective] stackLimit

Description

Use the stackLimit property to set (in script) the maximum size of the (runtime) stack the engine uses for recursive computation.

The stackLimit property allows a script to set (in bytes) the maximum size of the (runtime) stack the engine uses for recursive computation. A change in the setting will only take effect when all currently executing handlers complete, and at this time the stack size limit will be reconfigured to the given limit, or the nearest amount to it depending on available memory.

The recursionLimit property is now bounded by the stackLimit – attempts to set the recursionLimit greater than the stackLimit will see it downwardly adjusted to the maximum current size allowed.

note

The changes to the recursionLimit property and the new stackLimit property are only implemented on Windows at present.

Examples

set the stackLimit to 500

get the effective stackLimit

Related

property: recursionLimit

Compatibility and Support

Introduced

LiveCode 4.5.1

OS

windows

Platforms

desktop

server

mobile